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EZ Ifext Source Code 



p. 1 



%W% %E% Everett Stoub 

CcpyrigN: (c) '96- '97 ICN Web Products, Inc. All Rigjits Reserved. 

ez_text ^plet displa/s snaking text with in-line gr^ihics 
and produces a reader screei frame vtten clicked 



©author Everett Stoub %G% 



V 



airport java.awt,*; 
iirport java.^plet.*; 
inport java.net.*; 
irrport java.io.*; 
irrport java.util.*; 

public class ez_te>ct extends i^let 
{ 



private final boolean format tedText 


= true; 


and pull quotes are enabled 






private String 


title 


= null; 


private String 


article 


= null; 


private ezrpnl^ 


panel 


= null; 


private ezrf nrap 


fraiTB 


= null; 


private MediaTracker 


tracker 


= null; 


private Vector 


imageFileJ^femes 


= null; 


names for document 






private Vector 


graphicsURLs 


= null; 


inage URLs for documoit 






private Vector 


graphicslmages 


= null; 


images for documait 






private final boolean 


frameCption 


= true; 


reduction 






private final int 




= 0; 


private final int 


T.TNR 


= 1; 


private final int 


FLAT 


= 2; 


private final int 


RAISED 


= 3; 


private final int 


DROPPED 


= 4; 


private final int 


RICHED 


= 5; 


private int 


frame^]^^ 


= ICNE; 


private int 


frameSize 


= 0; 



// if true, in-line graphics 



// vector of all iitage file 
// vector of all graphic 
// vector of all graphic 



// set false for 1Kb code 



private final String PG = 

private final String AM = 

private final String SC = ";" 

private final String SP = " " 

private final String PL = "<p"; 

private final String QL = ''\""; 

private final String PR = "<p>"; 
private final String = "quot"; 



private final String 
private final String 
private final String 



alert_0 = "PLEASE READ - A Java "; 
alert_l = "Exception has occurred. "; 
alert_2 = "Most likely, there has been a transmission 
failure with one or more applet files. A Refresh or Reload oormand on your browser 
will scmetimes lead to a successful download. "; 

private final String alert_3 = "An attarpt to read a local file has been 
detected! In order to read this article, you must download the applet using b/per-text 
transport protocols (http://. . .) fron a web server. Please try again using http with a 
valid URL. "; 

private final String alert_4 = "If the prdblon persists, please contact the Web 
mster."; 
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1 

2 public final void dbg (String s) 

3 { 

4 if (debug) system.out .println(s) ; 

5 ) 

6 private boolean debug = false; // Print debugging info? 
7 

8 public String getTltleO 

9 { 

10 // dbg("ezrpnl^.getTitle() ") ; 

11 

12 return this. title; 

13 } 
14 

15 public final void paint (Gr^hics g) 

16 { 

17 // dbg(''ez_text.paint() : franHOVpe =''+franeTVpe) ; 
18 

19 if (fraireCption) 

20 { 

21 int i; 

22 Diinension d = sizeO ; 

23 switch (framsfiype) 

24 { 

25 case LINE: 

26 { g.setColor (getForegroundO ) ; 

27 for (i = 0; i < frameSize; i++) 

28 g.drav^ijine(0,d.height-i-l,d.width-i-l,d.height-i-l) ; 

29 } break; 

30 case FIAT: 

31 { g . setColor (get Foreground ( ) ) ; 

32 for (i = 0; i < frarreSize; i-H-) 

33 g.dravy^lect(i, i,d.vddth-2*i-l,d. height -2*i-l) ; 

34 } break; 

35 case RAISED: 

36 case DROPPED: 

37 case EHCTED: 

38 { boolean raise = fraiTieiype==RAISED; 

39 int R = (getForegroundO .getRed()+ getBackgroundO .getRedO )/2 

40 int G = (getForeground ( ) . getGreen ( ) +getBackground ( ) . getGreen ( ) ) /2 

41 int B = (getForegroundO .getBlue()+ getBackground( ) .getBlueO )/2 

42 g . setColor (new Color (R, G, B) ) ; 

43 for (i = 0; i < frameSize; i++) 

44 { 

45 if (frarrerr^ == ETCHED) raise = i >= franeSize/2; 

46 g.draw3DRect (i, i, d.width-2*i-l, d. height -2*i-l, raise) ; 

47 } 

48 if (frameoype == ETCHED) 

49 { 

50 g . setColor (getForeground ( ) ) ; 

51 g . drawLine (0,0, f rarTBSize/2 , f raireSize/2 ) ; 

52 g . drawLine ( d . width-f rameSi ze , d . height - f raireSize , d . width- 

53 fraineSize/2,d.height-fraiTBSize/2) ; 

54 g . setColor (getBackground ( ) ) ; 

55 g.drawLine(frarneSize/2,fraitieSize/2,frarrBSize,frarnsSize) ; 

56 g . drawLine (d .width-f rameSize/2 , d . height -franBSize/2 , d . width- 

57 l,d.height-l); 

58 } 

59 else 

60 { 
61 

62 g . setColor ( ( f ramaT>/pe==RAISED) ?getBackground ( ) : getForeground ( ) ) ; 

63 g.drawLine (0,0, frarreSize, frarreSize) ; 
64 

65 g . setColor ( ( f rameIVpe==RAISED) ?getForeground ( ) : getBackground ( ) ) ; 

g . drawLine (d .width-f raiieSize, d . height- framsSize, d . width- 

67 l,d.height-l); 

68 } 

69 } 

70 } 
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1 } 

2 } 
3 

4 public synchronized linage fetchljmage{ String fileNams) 

5 { 

6 // dbgCez^text.fetchlmageC+fil^fem&i-*')''); 
7 

8 if ( ! f ormattedText II fil^^feme == null) 

9 { 

10 return null; 

11 } 

12 else 

13 { 

14 IiTHge thelmage = null; 
15 

16 int inageiDatabaselndex = // get referarce to iitage 

17 database file name 

18 imageFileNames . indexOf ( f ileName) ; 
19 

20 if (inageDatabaselndex < 0) // not register^ yet : 

21 add it in 

22 { 

23 , URL theURL = null; 
24 

25 tiy // look in the 

26 documoitBase 

27 { 

28 theURL = new URL(getDocumentBase() , f il^Oams) ; 

29 Ir^tStream is = theURL.openStreamO ; // test connection 

30 thelimge = getlirage ( theURL) ; 

3 1 tracker . addlrage { thelirage , 0 ) ; 
32 

33 // juirp-start image loading 

34 

35 tracker . checkID ( 0 , true ) ;. 

36 try { tracker.vaitForlD(O) ; } 

37 catch ( InterruptedException ie ) { } 

38 Irrage buf feredTrrage = createIiTage(l, 1) ; 

39 if (bufferedlmage != null) 

40 { 

41 Graphics bg = buf f eredlmage . getGraphics ( ) ; 

42 if (bg != null) 

43 { 

44 bg . drawlnage { thelirage ,0,0, this ) ; 
,45 bg.disposeO ; 

46 } 

47 ) 

48 buf f erediirage . flush ( ) ; 

49 } 

50 catch {MalfonredURLExc^tion u) 

51 { 

52 Systen.out .println ( "ez^text . f etchlmage ( "+f ileNaiTie+" ) : 

53 MalformedURLExc^tion = "+u); 

54 thenjmage = null; 

55 ) 

56 catch (lOException io) 

57 { 

58 System . out . println ( " ez_text . f etchlirage ( " +f ileNaiie+ " ) : Ir^ut Stream 

59 lOException = "+io) ; 

60 thelmage = null; 

61 } 
62 

63 // update iitage database for document 

64 

65 irmgeFileNames .addElement (f ileName) ; // the filenarre is the 

66 nain key to iirage database access 

67 graphicsURLs-addElement (theURL); // in case we need to 

68 download it again later 

69 graphicsIrrages.addElenent (thelrrage) ; // this nay be reset to 

70 null with irrageJJixjate 
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1 } 

2 else 

3 { 

4 thelimage = ( Image) gr^McsInages . elementAt ( imageDatabaselndeJc) ; 

5 ) 
6 

7 return thelrage; 

8 ) 

9 ) 
10 

11 public void disposeF'raine { ) 

12 { 

13 // €3bg ( "ez_tejct .disposeF'raiTe ( ) " ) ; 
14 

15- if (frame != null) 

16 { 

17 Event evt = new Event (frame, Eveit.WIMX)W_DESIROfY, null); 

18 Carpanent co[] = frame.getCanrponents () ; 

19 for (int i = 0; i < co. length; i-H-) 

20 co[i] .handleEvent(evt) ; 
21 

22 f raine . dispose 0 ; 

23 frame = null; 

24 ) 

25 } 
26 

27 public boolean mouseiUp (Event evt, int x, int y) 

28 { 

29 // dbg ( " ez_text .mouset^ ( Event " +evt+ " , int " +x+ " , int " +y+ " } " ) ; 
30 

31 if (frarre != null) 

32 frame . toFrcnt ( ) ; 

33 else 

34 fraiTB = new ezrfrrrap (title, article, this); 
35 

36 return false; 

37 } 
38 

39 public String htiTiLCanan( String itsTtoct, boolean convertNWSs) 

40 { 

41 // dbg ( "ezrpnlap .htmlCanon ( \n "+itsTe>ct+" \n , 

42 " +convertWWSs+ " ) " ) ; 
43 

44 if { ! f orrrattecJUext ) 

45 return itsTfext; 
46 

47 if (oonvertr^s) // look for 

48 ['title<p]... 

49 { 

50 String LCtext = itsTe>ct . toLowerCase ( ) ; 
51 

52 if (LCtext. startsWith (AG) ) // initial accent 

53 grave specifies article title 

54 { 

55 int endrltle = LCtext. indexOf (PL) ; // end of line after 

56 cancnization 

57 if (endHtle > 0) , 

58 { 

59 title = itsText. substring ( 1, endHtle) ; 

itsText = itsText. substring (eidTitle); 



60 

61 ) 

62 ) 

63 } 

64 else 

65 { 

// replace character entities with spaces (except quot -> \") 

67 

Stringlbkenizer entities = new StringIbkenizer(itsText,AM, true) ; 
°^ StringBuffer newText = new StringBuffer(70) ; 
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1 vMle ( entities. l^sMoreWDka:is 0 ) 

2 { 

3 String eitity = // [boc^ 

4 text] , [&) (#nnn;bod/ text) ,...,(&] [#nnn;boci^ text) 

5 entities . nextlbJcai (AM) ; 
6 

7 if (entity.equalsi^)) 

8 { 

9 Stririg eTText = // should be 

10 character entity text #nnn or name 

11 entities . next1b)cen ( SC) ; 
12 

13 eitity = entities.nextTbkenO ; // should be ";*• if 

14 eTTtext is valid character entity value 
15 

16 if {entity. equals (SC) ) // r^lace character 

17 entity with local character (set) 

18 { 

19 if (eText.equals(QT)) 

20 { 

21 neVText . append (QL) ; 

22 } 

23 else 

24 { 

25 neft/Text . append ( SP) ; 

26 } 

27 } 

28 else // syntax error: 

29 { 

30 nev/Itext . append {?M) . append ( eWext ) . append ( entity) ; 

31 } 

32 } 

33 else 

34 { 

35 nev/Dext.appa:id(entity) ; // standard text 

36 } 

37 ) 

38 itsText = ne\A/rext . toString ( ) ; 
39 

40 // look for [<title. . .>title text</title. . . ] 

41 

42 String LCtext = itslfext . toLowerCase ( ) ; 

43 

44 int ending = 0, starts = LCtext .indexOf(*'<title" ) ; 

45 if (starts > -1) 

46 { 

47 starts = LCtext.indexDf (">", start s)+l; // start of title 

48 if (starts > 0 && starts < LCtext. length () ) 

49 { 

50 ending = LCtext .indexOf ("</ti tie", starts) ; 

51 if (aiding > -1) 

52 { 

53 title = itsText . substring ( starts , ending) ; 

54 ) 

55 } 

56 ) 
57 

58 // look for [<bocV. • .>ba^ text</body. . .] 

59 

60 starts = LCtext.indexOf ("<bod^") ; ' 

61 if (starts > -1) 

62 { 

63 starts = LCtext . indexOf ( " >" , starts ) +1 ; // start of boc^ 

64 ' if (starts > 0 && starts < LCtext . length () ) 

65 { 

66 ending = LCtext. indexOf("</boc^", starts) ; . 

67 if (eiding > -1) 

68 { 

69 return itsText . substring ( starts , ending ) ; 

70 } 
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1 } 

2 ) 

3 } 

4 return itslfext; 

5 ) 
6 

7 public String lineCanon{ String its^Itext, boolean convertCFls) 

8 { 

9 // dbg(*'e2_text.lineCanon()"); 
10 

11 if (itsTfext = null 

12 II itsText. length 0 ==0) retiam itslfext; 
13 

14 String newSeparator = convertCRs?PR:SP; // target return oode 

15 String searchSeparators ( ] = // r^lacable return 

16 codes 

17 { 

18 '•\n"+''\r", // chr(lO), chr(13) 

19 ''\r-+-\n\ // chr(13), chr(lO) 
20 

21 "\r", // chr(13) 

22 "\n", // chrdO) 

23 "Xf" // chr(12) 

24 }; 

25 String ne^/Text = new String ( itslfext ) ; 
26 

27 for (int i = 0; i < searchSeparators . length; i++) // replace old with 

28 new 

29 { 

30 String oldSeparator = new String (searchSeparators [i] ) ; 

31 neVText = replaceString (newText, oldSeparator, newSeparator) ; 

32 } 

33 return neVIfext; 

34 } 
35 

36 public String replaceString 

37 ( String theString // original string 

38 , String oldString // replace-ee 

39 , String newString // replace-or 

40 ■ ) 

41 { 

42 // dbg ("ezjifext. replaceString (theString, old: "+oldString+" , new: 

43 " +newSt ring+ " ) " ) ; 
44 

45 StringBuffer out = new StringBuffer( ) ; 

46 

47 int oldlndex = -1, oldEid = 0; 

48 int oldLength = oldString . length () ; 
49 

50 Oiile ((oldlndex = theString. indexOf (oldString, oldEnd) ) > -1) 

51 { 

52 String piece = theString.substring(oldEnd, oldlndex) ;// got it? get it! 

53 good. . . 

54 out. append (piece) ; // add the piece 

55 before the next old string 

56 out. append ( newString ) ; // get the 

57 r^lacenent 

58 OldEnd = oldlndex + oldLength; // skip to the end of 

59 this old string 

^ // nothing more to 

61 replace 

62 if (oldEnd < theString. lengthO) 

63 { 

64 String piece = theString. substring (oldEnd) ; 

65 out. append (piece); // add the piece 
65 after the last old string 

67 } 

68 return out . toString ( ) ; 

69 } 
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1 public Insets insets () 

2 { 

3 // dbg( "ezrpnlap. insets ()") ; 
4 

5 if (frameCption) switch (frame^iype) 

6 { 

7 case LINE: 

8 return new Insets (0, 0, f raineSize, 0) ; 

9 case FLAT: 

10 case RAISED: 

11 case DEOPPED: 

12 case ETCHED: 

13 return new Insets (frameSize, franeSize, frameSize, franeSize) ; 

14 } 

15 return new Insets (0, 0, 0, 0) ; 

16 } 
17 

18 public void initO 

19 { 

20 // dbgCez^text.inito: parent background = ''-^getParent () .getBackgrcfundO ) ; 
21 

22 if (forrattednext) 

23 { 

24 imageFil^^ames = new Vector (10) ; // mjst be created 

25 before calls to fetchlnBge 

26 graphicsURLs = new Vector (10) ; // must be created 

27 before calls to fetchlrrage 

28 graphicslmages = new Vector (10) ; // must* be created 

29 before calls to fetchlrmge 

30 } 
31 

32 tracker = new MediaTracker (this) ; 

33 

34 String s = getParameterC'fileName") ; 

35 if (s != null) try // new URL, etc. 

36 { 

37 URL url = new URL(getDocurrentBase() , s) ; 

38 Ir^utStream is = url .openStream( ) ; 

39 BufferedlrputStream bis = new BufferedliputStream(is) ; 
40 

41 int len = 0; 

42 h/te buffer [] = new tyte[512); 

43 StringBuffer pageText = new StringBufferO ; 

44 v^le (den = bis . read (buff er) ) > 0) 

45 pageOfext. append (new String (buffer, 0,0,len) ) ; 
46 

47 bis. close 0 ; 

48 is.closeO ; 
49 

50 boolean toHTML = s . toLowerCase {) .endsWith( " .txt") I I 

51 s.toLcwerCaseO .endsWithC'.text") II s.toLowerCaseO .endsWithC .nws") ; 

52 article = htmlCanon // retains only 

53 sipported tags 

54 ( lineCanon (pageTejct . toString ( ) 

55 / tcHTML) // true converts 

56 'CR's to '<p>'s 

57 / toHIML // true converts 

58 enews tags to html 

59 ); // strips off head & 

60 saves title 
61 

62 // start loading in-line graphics right away 

63 

64 Stringlbkenizer images = new Stringlbkenizer (article, "0", true) ; 

65 v*iile (irmges.hasMorerrbkensO ) 

66 { 

67 String token = irrages.nextTbkenO ; 

68 if (token. equals ("(3")) 

69 { 
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1 String filename = inBges.nextTbken(*'<'') ; // <p> following 

2 file^3aIrle 

3 if (file^IaITe.toLcwerCase() .endsWit±i(" 

4 II fil^^fenie.toLowerCase() .endsWith(''.gif'')) 

5 f etchlnage { f il^Sbme . trim ( ) ) ; 

6 ) 

7 } 

8 } 

9 catch (lyfelforrnedURLException nu) 

10 { 

11 StringBuffer msg = new Strir^^fferO ; 

12 insg.^:pend{alert_0) . append ("lyfelformed URL 

13 ") .^pend(alert_l) . append (alert_2) . append (alert_4) ; 
14 

15 article = msg.toStringO ; 
16 

17 String e = "Could not cpen "+5; 

18 showStatus(e) ; 

19 syst€m.out.println(e+*' ; exception: "-tmi) ; 

20 ) 

21 catch (lOExc^tion io) 

22 { 

23 StringBuffer msg = new StringBufferO ; 

24 neg. append (alert_0) . append ( "Ir^t /Output 

25 ") . append (alert_l) . append (alert_2) . append (alert_4) ; 
26 

27 article = nsg.toStringO ; 
28 

29 String e = "Could not cpen "-t-s; 

3 0 showStatus ( e ) ; 

31 system. out .println(e+"; exception: "+io) ; 

32 } 

33 catch (SecurityException se) 

34 { 

35 StringBuffer msg = new StringBufferO; 

36 msg.append(alert_0) .append ("Security 

37 ") . append (alert_l) . append (alert_3) . append (alert_4) ; 
38 

39 article ~ msg.toStringO ; 
40 

41 String e = "Could not cpen "+s; 

42 shcwStatus{e) ; 

43 System.out.println(e^-"; exertion: "+se) ; 

44 } 

45 else 

46 { 

47 StringBuffer msg = new StringBufferO; 

48 msg.append(alert_0) . append ("Iiput /Output ") . append (alert_l) ; 

49 msg. append ("No article file specification was detected! "); 

50 msg. append (alert_2) . append (alert_4) ; 
51 

52 article = msg . toString ( ) ; 
53 

54 String e = "No file^3arre specified"; 

55 showStatus (e) ; 

56 Syston.out .println (e) ; 

57 } 

58 this . setLayout (new BorderLayout () ) ; 

59 this . setBackground (getParent ( ) . getSackground ( ) ) ; 

60 this . setForeground (getP^rent ( ) . getForeground ( ) ) ; 
61 

62 panel = new ezrpnlap (article, this, false); // mr the reader 



63 screen 



64 

65 // add insets for applet boundaries . . . 

66 this. add( "Center", panel); 
67 

68 if (frameCption) 

69 { 

String b = getParBmeter("frarreType"} ; 
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p. 9 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 



if 
{ 



(b != null) 



b = 


: b.tdUpperCaseO ; 












if 


(b.equals{-LINE'')) { 


frameSize = 


1; 


f rameOVpe = 


LINE; 


} 


if 


(b.equals("FIAT*')) { 


frameSize = 


1; 


f rarreOype = 


FLAT; 


) 


if 


(b. equals {-RAISED")) { 


frameSize = 


2; 


f rame^^pe = 


RAISED; 


} 


if 


(b . ec3uals ( "DROPPED" ) ) { 


franeSize = 


2; 


f ramenvpe = 


CROPPED; } 


if 


(b.equals("EICHEr")){ 


franeSize = 


4; 


f rameT/pe = 


ETCHED; 


} 



String w = get Parameter ("franeSize") ; 
if (w != null) 

try {frameSize = Integer, parselnt(w) ; 
catch (NurriberFormatException nf ) {. 



* %W% %E% Everett Stoub 

* Copyri^t (c) '96- '97 ICN Web Prodacts, Inc. All Rights Reserved. 

* ez„text applet reader screen frame 



/** 



^author Everett Stoub %I%, %G% 



V 



inport java.awt.*; 

iitport java. applet.*; 

inport java.net.*; 

inport java.io.*; 

inport java.util.*; 

public final class ezrfnrap extends Frame 
{ 



// 



private ezrpnl^ 
private Panel 
private ez_text 
private Label 
private boolean 



readerScireen; 
control ; 
ezjifext ; 
footer; 
dano = true; 



private String battonNane[] = 
"Hare" 
"Previous" 
"Next" 
"Font +" 
"Font -'* 



public ezrfnTHp( String title, String readerContent , 
{ 

siper (title) ; 



ez_tejct ez_Text) 



// dbg("ezrfrmap.<init>") ; 
this.ezjText = ezJUext; 

this.readerScreen = new ezrpnlap(readerContent, ez_1iext, true); 
this . add ( "Center" , readerScreen) ; . 

control = new Panel (); 
control . setBackground (Color . gray) ; 
// control . setLayout {new FlowLayout ( FlowLayout . RIGHT) ) ; 
control . setLayout (new FlowLayout {FlowL^out .CENIER) ) ; 

StringBuffer version = new StringBufferO ; 
version.aFpend("ICN EZ Text "); 
if (deiTo) 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
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versicn.^jpaTdCDemo") ; 



else 



version .append ( " vl . 03 ** ) ; 



p. 10 

// [An-major] . [An-mLnor] [M-tweak] [Aa-f ix] 



cxjntrol . add (new Label (version . toString ( ) ) ) ; 
for (int i = 0; i < buttonName. length; i++) 
{ 

Button b = new Button ( but taril>feiTie(i] ) ; 
b . setBackground (Color .vMte) ; 
control. add (b) ; 

) 

control. add (new Label ("(c) '97 ICN S/stare, Inc. 888.ICN.JAVA") ) ; 

this, add ("South", ocntrol); 

this. pack 0 ; 
this.shovO ; 

} 

public boolean action (Event e, Object o) 
{ 

if (e. target instanceof Button) 



readerScreen . doViewerHone ( ) ; 
readerScreen . doViewerLef t ( ) ; 
readerScreen . doViewerRight ( ) ; 
readerScreen. doViQ^7erSi2e( false) , 
readerScreen. doViewerSize (true) ; 



{ 

if (o == (buttonNams[0])) 
if (o == (buttonr^fama[l]) ) 
if (o == {buttonNairB[2])) 
if (o == (buttonNarre[3])) 
if (o == (button^3a^B[4])) 
return false; 

// repaint ( ) ; 
return true; 

) 

else return false; 

) 



/* private final void dbg (String s) 
{ 

i f (debug ) System . out . print In { s ) ; 

} 

private boolean debug = false; // Print debugging info? 



else 
else 
else 
else 
else 



V 

public final boolean keyDown (Event evt, int ke/) 
utilized at all (missing in JDK 1.02 on mc) 
{ 

// dbg ( "ezrf ntap.ke/Down ( "+evt+" , "+ke/+" ) " ) ; 
boolean down = key == Event. DCW; 



// note: keyVp is not 



tnie; 



true; 



true; 



true; 



} 



switch (key) 
{ 

case Event .HCME: 

case EvQit.PGEN: 
case Event. RIGHT: 

case Event. PGUP: 
case Event. LEFT: 

case Event. UP: 
case Event .DOWN: 



return false; 



readerScreen . doViewerHome ( ) ; 
readerScreen. doViewerRight ( ) ; 
readerScreen . doViewerLef t ( ) ; 
readerScreen . doViewerSize (down) ; 



repaint ( ) ; return 

repaint ( ) ; return 

repaint ( ) ; return 

repaint ( ) ; return 



public final boolean handleEvent (Event evt) 
// dbg ( "ezrf nrap . handleEvent ( " +evt+ " ) " ) ; 
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1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 



) 



switch (evt.id) 
{ 

case Event .WINDOW JXPOSE: 
case Ev^t.WINlXWJDEIOCNIFY: 
case Event, Vm^XMJLQOtUFY: 
case EX^t.WINBXW_DESTROT: 
} 

return sijf^er .handleEvent (evt) ; 



readerScreai.requestPocusO ; 

this.showO ; 

this.hideO; 

ezJPext . disposeFraire ( ) ; 
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break 
break 
break 
break, 



public void \jpdate (Gr^Mcs g) 
{ 

// g . setColor (getBackground ( ) ) ; 

// g.fillRect(0, 0, width, heicjit) ; 

g . setColor (getFtoregramd ( ) ) ; 

paint (g) ; 

) 



%W% %E% Everett Stoub 



Cpp/right (c) '96- '97 ICN Web Products, Inc. All Rights Reserved, 
web crawler with ReaderScreen 



Gauthor Everett Stoub %G% 



V 



iirport java.awt.*; 
iirport j ava.awt. image.*; 
irrport j ava. applet .*; 
iirport java.net.*; 
irrport java.io.*; 
iirport java.util.*; 

public final class ezrpnlap extends Panel 
{ 

public final static int LEFT 
pi±>lic final static int CENTER 
public final static int RIGffT 
public final static String MT 
public final static String EL 

private boolean dato 
private final boolean fonrBttedliext 
pull quotes are enabled 



private ez_text 

private String 
private Image 

private int 



ezjtect 

readerContent 
readerScreen 

readerFcntSize [ ] 



= 0 
= 1 
= 2 



= true; 
= true; 



= null; 

= null; 
= null; 

= { 8, 



// 
// 



mild display spam 

if true, in-line graphics and 



9,10,11.12,14,18,24,30,36,42,48,56,64,72,80,96}; 

private int readerFootlndex = 2; 

hard coded in stepFontSizeO 

private int ' r^derSizelndex = 4; 

rendering 

private int readerPullIndex = 5; 

hard coded in stepFontSizeO 

private int readerHeadlndex = 6; 

hard coded in stepFontSizeO 

private Font readerFooterFont = null 

private Font readerScreenFont = null 

private Font readerPQuoteFont = null 

private Font readerHeaderFont = null 



// 



// 



// 



this 2 -step decrement is also 
default for on-webPage article 



this 1-st^ increment is also 
// this 2-st^ increment is also 



12/8/97 



EZ Tfext Source Code 



p. 12 



1 




UlC 


rRaaETALLyi aiSlC 


= LEFT; 


9 


privace 


inc 


reauerireriiuec.er 


= 10; 


-5 
J 


prxvace 


rat- 
ine 


reaoerrsiuiTuois 


= 1 






pinvate 


Ult 


readerLeading 






c 


private 


int 


reader BageNum 


= 1 




£: 
D 


piivace 


inu 


readert'^jrnF^ges 


= 0, 




/ 


pinvate 


Hit 


rsader Es t Pages 


= 1. 




o 
o 


private 


int 


readerEndlndex 


= 0, 




9 


private 


int 


readers tart Index 


= 0, 




iU 


private 


int 


readerTextLength 


= 0 




11 


private 


boolean 


readerScreenDirty 


= true; 


12 


private 


boolean 


readerFraitie 


= false; 


13 


frame 










14 


private 


boolean 


readerHeader 


= false; 


15 


'title 











16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
•36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 



// true if panel needs redraw 
// true if panel owned ty 

// true if article begins with 



private Color 
private Vector 
private Rectangle 



readerBackColor 
readerPageStart 
readerRect 



new Color(231,231,231) ; 
new Vector (50) ; 
new Rectangle ( ) ; 



// variable principally for paintTextArea 



private int 
private int 
private int 
private int 

private boolean 
quote display 

private boolean 
quote content 



IcwestTextAreaBaseLine = 0; 
ccntrolSize = 0 

pullQuoteLin^idth = 2 
pullQuoteSizelncr = 1 

drawPulllMerliner = false; // switch to finish pull 

finishPullQuoteText = false; // switch to finish pull 



private 


boolean 


lastColuim 




= false; 


// current 


setting 


private 


boolean 


lastRow 




= false; 


// current 


setting 


private 


boolean 


parSpace 




= false; 


// curr^t 


setting 


private 


boolean 


priorEirptyPara 


= false; 


// current 


setting 


private 


Rectangle 


aheadRect 




= new Rectangle ( ) ; 




private 


Rectangle 


closeRect 




= new Rectangle ( ) ; 




private 


Rectangle 


abackRect 




= new Rectangle ( ) ; 




private 


Color 


pullColor 




= Color. blue; // 


current setting 


private 


Font 


textFont 




= null; 


// current 


setting 


private 


FanUyfetrics 


textMetrics 




= null; 


// current 


setting 


private 


Color 


textColor 




= null; 


// current 


setting 


private 


int 


textHeight 




= 0; 


// current 


setting 


private 


int 


textAlign 




= LEFT; 


// current 


setting 


private 


Rectangle 


textRect 




= null; 


// current 


setting 


private 


int 


colNum = 0, 


colWidt±i = 0, colSfpacing = 0, nurrColumns = 0, 


oneSetOf f = 


0; 












private 


int 


nextwidt±i = 


0, ^ = 


0, te = 0, 


xe = 0, ys = 


= 0, yb = 0, ye = 



0; 



public ezrpnlap (String readerContent , 
{ 

// dbg ( " ezrpnl^ . <ini t > " ) ; 



ez_text ezJText, boolean readerFrame) 



this.ezJText = ezjltext; 

this . readerFrame = readerFrarre; 

this. readerHeader = ez_Text.getTitle() != null; 

this . readerContent = readerContent; 

this , readerTextLength = readerContent . length ( ) ; 



if 
{ 



) 

else 



(readerFrame) 

this. setForeground (Color. black) ; 
this. setBackground( readerBackColor) ; 
stepFontSize( false) ; 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
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tMs.setBackground (Color ; 
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// this is a hack 



setAllFontsO; 



public synchranized void stepFcntSize (boolean smaller) 
{ 

// dbg ("ezrpnl^. StepFcntSize { snaller = '•+srTaller+'') ") ; 



1),0) 
1),0) 
1),0) 
1),0) 

) 



if (snaller) 
else 

readerHeadlndex 
reader Pulllndex 
readerFootlndex 

readerSizelndex 

readerHeadlndex 

readerPullIndex 

readerFootlndex 

setAllFcnts ( ) ; 



readerSi zelndex — ; 
readerSizeIndex++ ; 

readerSizelndex + 2; 
readerSizelndex + 1; 
readerSizelndex - 2; 

Math.nBx(mth.rnin{readerSizeIndex,readerFontSi2e.laigth - 
^feth.rlBx(^fetll.Inin(readerHeadIndex,readerFontSize. length - 
^lath.ITBx(^feth.I^in(readerPullIndex,readerFontSize. length - 
Math . rtBx (l^th . min ( readerFootlndex , readerFont Si ze . length - 



pi±>lic synchronized boolean iimgeUpdate(IrTBge img, int flags ^ int x, int y, int w, 
ixit h) ■ 
{ 

// dbg ( " ezrpnlap . imagel^xaate ( flags = " +f lags+ " ) " ) ; 



if (fomattedText && (flags & IrrBgeObserver.ALLBITS) != 0) 
ccnrplete (at last) 
{ 

// resetReaderViewO ; 

repaintReaderScreen { ) ; 
return false; 

) 

else 

return true; 

) 

public final synchronized void doViewerHore 0 
{ 

// dbg ( " ezrpnlap. doViewerHone () " ) ; 
if (readerPag^to > 1) 



// this image is 



{ 



} 



readerPageNum = 1; 
readeiStart Index = 

( ( Integer) readerPageStart . elementAt ( 
readerPageNum-l) ) . intValue ( ) ; 



repaintReaderScreen ( ) ; 



} 



public final synchronized void doViewerLef t ( ) 
{ 

// dbg ( *' ezrpnlap . doViewerLef t () " ) ; 

if ( reader PageNum > 1) 
{ 

reader PageNum— ; 
readerStartlndex = 

( (Integer) readerPageStart . elementAt ( 
readerPageNum-1) ) . intValue ( ) ; 



12/8/97 EZ Ttext Source Code p. 14 

1 ) 

2 repaintReaderScreen ( ) ; 

3 ) 
4 

5 public final synchronized void doViewerRight ( ) 

6 { 

7 // dbgCezrpnl^.doVie^jerRight 0 : readerEhdlndex = ''+readerEiTdIndex) ; 
8 

9 if (rBaderEMEndex < readerlfextLength) 

10 { 

11 readerPag^SluiTH-+ ; 

12 if (readerNumPages < readerf^geNum) 

13 { 

14 readers tart Index = readerDidlndex - 1; 

15 readerBageStart . addElarent ( 

16 new Integer (readerStartlndex) ) ; 

17 ) 

18 else // been there, done that 

19 { 

20 readerStartlndex = 

21 ( ( Integer) readerPageStart . elanentAt ( 

22 readerPageNum-1 ) ) . intValue ( ) ; 

23 } 

24 } 

25 else if {readerNumPages == 0) 

26 { 

27 readei1>IumF^ges = readerPageNum; 

28 } 

2 9 repaintReaderScreen ( ) ; 
30 ) 

31 

32 public final synchronized void doViosferSize (boolean srtaller) 

33 { 

34 // dbg ( " ezrpnlap . doViewerSize (boolean " +srraller+ " ) " ) ; 
35 

36 st€pFontSize(snaller) ; 

37 setReaderRect ( ) ; 

38 resetReaderView ( ) ; 

3 9 repaintReaderScreen ( ) ; 
40 } 

41 

42 public synchronized void setAllFonts ( ) 

43 { 

44 // dbg ( " ezrpnlap . setAllFonts () " ) ; 

45 ■ 

46 readerFooterFont = new Font ("TirresRcrrBn", Font. PLAIN, 

47 readerFontSize [readerFootlndex] ) ; 

48 readerScreenFont = new Font ("TiresRaiBn" , Font. PLAIN, 

49 readerFontSize (readerSizelndex) ) ; 

50 readerEQuoteFont = new Font ( "TuresRaran" , Font. PLAIN, 

51 readerFontSize [readerPullIndex] ) ; 

52 readerHeaderFont = new Font ("TdmssRaman" , Font. PLAIN, 

53 readerFontSize [readerHeadlndex] ) ; 

54 } 
55 

56 public synchronized void setReaderRect ( ) 

57 { 

58 // dbg ( " ezrpnlap . setReaderRect ( ) " ) ; 
59 

60 setReaderRect ( this . bounds ( ) ) ; 

61 } 
62 

63 public synchronized void setReaderRect (Rectangle r) 

64 { 

65 // dbg ( *' ezrpnlap . setReaderRect { " +r+ " ) " ) ; 
66 

67 readerRect . resh^^e 

68 ( 1 

69 , 1 

70 , r.width - 1 
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1 , r.hei^t - 1 - (readerFcame?readerFontSize(readerFootIndex] *3/2 :0) 

2 ); 

3 } 
4 

5 public boolean inouseUt>( Event evt, int x, int y) 

6 { 

7 // dbg Cezrpnlap.iTDuseiUt) (Event "+€^1:+", int •'+X+'', int •'+y+'') "); 
8 

9 if {! reader Frame) return false; 

10 else 

11 if (aheadRect. inside (x,y ) ) 

12 { 

13 doViewerRi^tO; 

14 return true; 

15 ) 

16 else 

17 if (closeRect. inside {x,y ) ) 

18 { 

19 ezjltext . disposeFrame { ) ; 

20 return true; 

21 } 

22 else 

23 if (abackRect. inside (x,y ) ) 

24 { 

25 doViewerLef t ( ) ; 

26 return true; 

27 } 

28 else return false; 

29 } 
30 

31 public final Dimension minimumSize ( ) 

32 { 

33 // dbg ( " ezrpnlap .minimumSize { ) " ) ; 
34 

35 return new Dimension (585, 400); 

36 } 
37 

38 public final Dimension pref erredSize ( ) 

39 { 

40 // dbg ( "ezrpnlap. pref erredSize ( ) " ) ; 
41 

42 return minimumSize ( ) ; 

43 } 
44 

45 public synchronized void reshape (int x, int y, int width, int height) 

46 { 

47 // dbg ("ezrpnlap. reshape ("+x+", "+y+", "+width+", "+height+" ) " ) ; 
48 

49 IcwestTextAreaBaseLine = 0; 

50 readerScreenDirty = true; 

51 resetReaderViewO ; . 
52 

53 // fillRect is performed here rather than in i5x3ate(g) 

54 

55 getGraphics ( ) . setColor ( getBackground ( ) ) ; 

56 getGraphics 0 .fillRect (0, 0, width, height); 

57 getGraphics ( ) . setColor (getForeground ( ) ) ; 
58 

59 sijper. reshape (x, y, width, height); 

60 } 
61 

62 public final synchronized void paint (Graphics g) 

63 { 

64 // dbg ( " ezrpnlap . paint (g ) " ) ; 
65 

66 if (readerScreenDirty) 

67 { 

68 if (readerScreen != null) 

69 readerScreen . flush ( ) ; 

70 readerScreen = this.creat elmage( this. size {) .width, this. si ze() .height) ; 
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1 

2 Gr^]ihics q = this.readerScreen.getGraphicsO ; 

3 paintReaderScreen (q) ; 

4 q. dispose! ); 

5 readerScreenDirty = false; 

6 ) 
7 

8 g.drawlmage (readerScreen, 0,0, this) ; 

9 } 
10 

11 private final synchronized void paintReaderScreen (Gr^)hics g) 

12 { 

13 // dbg { "ezrpnlap . paintReaderScreen (g) ) ; 
14 

15 Rectangle r = bounds ( ) ; 
16 

17 setReaderRect(r) ; // set to full area (this.boundsO ) 

18 g . setColor (getBackground { ) ) ; 

19 g.fillRect(0, 0, r.width, r. height ) ; 
20 

21 int nunCols = calculateReaderColurms ( ) ; 

22 if (nurrCols != readerNunCols) 

23 { 

24 readerNurrCols = nurrCols; 

25 resetReaderViewO ; 

26 } 
27 

28 if {readerFrame) 

29 readerLeading = 2; // nake it irore comfortable 

30 else 

31 readerLeading = 0; // noke it more aatpact 
32 

33 if (readerHeader Scfic IreaderFrame) // draw header (article title) 

34 { 

35 lowestltextAreaBaseLine = 0; 

36 g . setColor (Color .blue) ; 

37 int titleEhd = paintltextArea 

38 ( g // (Graphics g 

39 ,0 // int beginlndex 

40 , readerHeaderFont // Pent te>ctFcnt 

41 , ez_Tie>ct.getTitle() // String te>ctCantent 

42 ,1 //int nurrCols 

43 , CENTER // int alignrrent 

44 ); 
45 

46 lowestTtextAreaBaseLine += readerHeaderFont. get Si ze () /2; 

47 readerRect . resh^)e 

48 { 1 

49 , lowestTsxtAreaBaseLine 

50 , r.width - 1 

51 , r. height - lowestTfextAreaBaseLine 

52 ); 
53 

54 g . setColor (getBackground () ) ; 

55 g.fillRect(readerf^t.x, readerRect .y, readerRect .width, 

56 readerRect. heig^it) ; 

57 } 
58 

'59 if (dano && readerFrame) 

60 { 

61 Font sFont = new Font 

62 ( "Dialog" 

63 , Font.BOID 

64 , 2 *readerFont Size [ readerHeadlndex] 

65 ); 

66 setFont 

67 ( Color .v^^lite 

68 , sFcnt 

69 , g 

70 ); 
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1 String spam = "Deno" ; 

2 int sWide = text:Metrics.striii^idth(spam) , i, j; 

3 fca: 

4 ( j = 2*readerPerimeter + text:Heig^it/2 

5 ; j < readerRect .heigjit 

6 ; j += 3*textHeigJit/2 

7 ) 

8 far 

9 ( i = 4*readerPeriineter + textHeig^it/2 - j 

10 ; i < readerRect .width 

11 ; i += 3*sWide/2 

12 ) 

13 g. drawstring // draw the spam 

14 { spam 

15 , i + readerRect.x 

16 / j + readerRect.y 

17 ); 

18 ) 
19 

20 g . setColor (getForeground { ) ) ; 

21 

22 readerBidlndex = paintTextArea (g, readerStart Index) ; 

23 

24 if (readerNumE^ges == 0) 

25 { 

26 if ( reader Endlndex == readerlfextLength) 

27 readerEstPages = readerNumPages = readerPageNum; 

28 else // estiiTBte number of pages 

29 { 

30 readerEstPages = 

31 mth . round ( 0 . 5f + ( float ) readerPageNum* ( float ) readerTtextLength/ ( float ) readerEndlndex) ; 

32 ) 

33 } 

34 else 

35 readerEstPages = readerNumPages; 
36 

37 if (readerFrame) // draw footer (page information) 

38 { 

39 StringBuffer pi = new StringBufferO ; 

40 pi. append ("Screen .append (String. valueOf( readerPageiNum) ) .append (" of "); 

41 if (readerNumPages == 0) pl.append( ) ; 

42 pi. aFpend(String.valueOf (readerEstPages) ) ; 

43 String pagelnfo = pi . toString ( ) ; 
44 

45 int infcWidth = getFontMetrics (readerFooterFont) .stringWidth (pagelnfo) ; 

46 

47 g . setFont ( readerFooterFont ) ; 

48 g . setColor (getForeground ( ) ) ; 

49 int xLoc = (r .width - infdWidth) /2; 

50 int yLoc = r.heig^it - readerFontSize[readerFootIndex] /4 - 1; 

51 g. drawstring (pagelnfo, xLoc, yLoc) ; 

52 } 

53 ) 
54 

55 private final synchronized int paintTextArea 

56 ( Gr^hics g 

57 , int beginlndex 

SB ) // returns string 

59 index of first non-drawn character 

60 { 

61 // dbg (" ezrpnlap. paintTextArea (g, "+beginlndex+") : "+readerNum::ols+" columns"); 
62 

63 return paintTextArea 

64 ( g 

65 , beginlndex 

66 , readerScreenFont 

67 , this.readerContent 

68 , readerNurrCols 

69 , readerAlignment 

70 ); 
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1 ) 
2 

3 private final synchroaiized int paintltextArea 

4 ( Graphics g 

5 , int beginlndex 

6 , Font theFont 

7 , String te>ctCcntent 

8 , int nurrCols 

9 , int alignmsnt 

10 ) // returns string 

11 index of first non-drawn character 

12 { 

13 // dbgCezrpnl^.paintTextAreaO"); // 

14 paintTextArea(\n{g\n, '•+beginlndex+''\n ''+theFont+"\n, textContentXn ''+nurTCols+"\n, 

15 " +alignment+ " \n) 
16 

17 int endltext = textContent . length () ; 

18 int endlndex = beginlndex; 

19 boolean go = endlndex != endText; 

20 nurrColurms = nurrCols ; 
21 

22 textAlign = alignment; 

23 textColor = g.getColorO ; 
24 

25 this . setFont ( textColor, theFont , g) ; 
26 

27 ' StringTokenizer paragraphs = new Stringlbkenizer // break \3g the text 

28 into norral paragraphs 

29 (textContent .substring (beginlndex) , "<" , tnie) ; // final true returns 

30 token on next call 
31 

32 colNum = 0; 

33 int colMargin = 4*textMetrics.strin^idth(BL) ; // four spaces 

34 betv\?een cols 

35 colWidth = (readerRect .width - 2*readerPerirTeter - (nunColurms- 

36 1 ) *col^fergin ) /nurrColurms ; 

37 colSpacing = colWidth + colMargin; 
38 

39 String nextWord = MT; 

40 StringBuffer thisLine = new StringBuffer (70) ; 
41 

42 jd) = readerRect. X + readerPeriireter; // local left edge of 

43 the colurm area 

44 te =. jdD; // end position of 

45 this line's words 

46 xe = >dD + colWidth; // local right edge 

47 of the column area 
48 

49 nextWidth = 0; 
50 

51 ys = readerRect .y + (textHeight + readerLeading) *3/4; // local starting 

52 baseline of first line 

53 yb = ys; 

54 ye = readerRect .y + readerRect .height - textHeight/4; // local noximum 

55 baseline of last line 

56 lowestTsxtAreaBaseLine = yb} // lowest baseline in 

57 readerRect 

58 priorElrptyPara = false; // permits paragraph 

59 spacers 

60 lastColurm = colNum == nurrColumns - 1; 

61 lastRow = false; 

62 controlSize = textHei^t*2/3; 

63 oneSetOff = {textHeight + readerLeading) /2; // use stnd font size 

64 for half -space set-offs 

65 // dtgC... oneSetOff = "-KDneSetOff ) ; 
66 

67 abackRect . reshape 

68 ( readerRect. x + readerRect .width - 2 - (controlSize+4) *3 

69 / readerRect .y + readerRect. height - 4 - controlSize 

70 , controlSize + 4 
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1 , oontrolSize + 4 

2 ); 

3 if (debug) 

4 g.dravyS^ect (abackRect.x,abackRect.y,abackRect.vddt±i,c^ ; 
5 

6 closeRect. reshape 

7 ( readerRect.x + readeiitect .width - 2 - (cantrolSize+4) ^2 

8 , readerRect.y + readerRect.hei^t - 4 - oontrolSize 

9 , oontrolSize + 4 

10 , oontrolSize + 4 

11 ); 

12 if (debug) 

13 g .dravsJiect (closeiRect .x, closeRect .y , closeiRect .width, closeiRect .height ) ; 
14 

15 aheadRect . reshape 

16 ( readerRect.x + readerRect .width - 2 - (contrDlSize4-4) *1 

17 , readerRect .y + readerRect .height - 4 - oontrolSize 

18 , ccntrolSize + 4 

19 , ccntrolSize + 4 

20 ); 

21 if (debug) 

22 g.drav^ect(aheadRect.x,aheadRect.y,aheadRect.width,aheadRect.heic^it) ; 
23 

24 draw: v\*ule (paragraphs.haslVbremokensO && go) // paragr^±i to 

25 follow 

26 { 

27 String para = paragraphs . nextlbken ("<"); 
28 

29 // dbg(". . . new paragraph token = ["+para+"] ") ; 

30 

31 if (formattedText 

32 ScSc para . startsWith ("'")) // test for in-line 

33 title 

34 { 

35 // dbgC... piiLl quote: yb = "+yb) ; 
36 

37 rollBackO; 
38 

39 int pullQuoteHeight = 2*pullQuoteLineWidth // reserve pull-quote 

40 bars 

41 -f oneSetOf f * ( (yb <= ys)?l:2); // reserve 1 or 2 

42 setoffs outside bars 
43 

44 textAlign = CEIOTR; 

45 this .setFont (Color .blue, readerPQuoteFont^g) ; 
46 

47 pullQuoteHeight += textHeight + readerLeading; // reserve one 

48 pullquote line of text 

49 // dbgC... pullQuoteHeight = "+piillQuoteHeight) ; 
50 

51 if (yb + pullQuoteHeicJit > readerRect .y + readerRect. height) 

52 { // not enoucji roan in . 

53 this (partial?) colurm 

54 if (lastColumn) break draw; // no more columns 

55 left to fill 

56 nextColurmO ; 

57 yb = readerRect .y; // start at the tcp 

58 ) 

59 else if (yb > ys) // not at the top of 

60 the column? 

61 { 

62 yb += oneSetOff ; // upper set-off 

63 } 
64 

65 for (int line = 0; line < pullQuoteLin^idth; linen-) 

66 { 

67 g.drawLine(xb, yb, xe, yfcH-+) ; 

68 ) 

69 yb textHeight + readerLeading; // drop for next line 

70 drawPullUnderliner = finishPullQuoteTtext = true; 
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1 

2 para = para. substring (1) ; // drcp control 

3 character * 

4 endlndex++; // update locaticn 

5 } 

6 else if (formattedText 

7 drawPullUnderliner IfinishPullQuoteText) // restore stnd 

8 values 

9 { 

10 rollBackO; 
11 

12 for (int line = 0; line < pullQuoteLineWidth; line^n-) 

13 { 

14 g.drawLine(xb, yb, xe, yb++) ; 

15 ) 

16 drawPullUnderliner = false; 
17 

18 textAlign = alignment; 

19 this . setFont ( textColor , theFont , g) ; 
20 

21 if {yb > ys) 

22 yb += oneSetOf f 

23 + textHeicfit + readerLeading; // drcp for next line 

24 if (yb > ye) 

25 { // not enoucfi nxm in 

26 this (partial?) colurtn 

27 if (lastColumn) break draw; // no nore columns 

28 left to fill 

29 nextColurmO; 

30 } 

31 } 

32 . 

33 if (para.eqaals("<") ) // an htmL new 

34 paragraph? 

35 { 

3 6 String tagTPsxt = paragraphs . nextlbken ( " > " ) . toLcwerCase ( ) ; 

37 int tagLength = tagText . length () ; 

38 

39 para = paragraphs .nextTbken ( ) ; 

40 if (para.equals(">") ) 

41 { 

42 if (tagText.startsWithC'p")) 

43 { 

44 if (yb > ys && priorEhptyPara) // unless we're at 

45 the tcp 

46 { 

47 yb += textHeight + readerLeading; // drop dcwn to 

48 another line 

49 if (yb > ye) 

50 { // not enou^ roan in 

51 this (partial?) colurm 

52 if (lastColumn) break draw; // no nore columns 

53 left to fill 

54 nextColurmO ; 

55 } 

56 } 

57 } 

58 lowestltextAreaBaseLine = Math.max(lowestTextAreaBaseLine,yb) ; 

59 priorEirptyPara = true; 

60 } 

61 .endlndex += tagLength+2; 

62 } 

63 else if (formattedText 

64 && para . start sWith ( " @ " ) 

65 ( para.toLowerCaseO .endsWithC'.jpeg") 

66 II para.toLowerCaseO .endsWithC'.gif'*))) // test for in-line 

67 graphic 

68 { 

69 IriBge thelmage = ezJUext.fetchlrrBge (para. substring (1) .trimO ) ; 
70 
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1 if (thelnage != null) 

2 { 

3 rollBackO; 
4 

5 priorQrptyFtoa = false; 

6 

7 int wim = t±ielrnage.getwidth(ez_'ltext) ; 

8 int him = theImage.getHeight(ez_Text) ; 

9 if (wim > cx>lwidth) // scale gr^Mc down 

10 to coliJim width 

11 { 

12 him = mth.roundl { float ) colWidth * (float)hlm / {float)wIin ); 

13 wIm = colWidth; 

14 } 
15 

16 if (him > readerRect.heic^t) // scale gi^bic down 

17 to coluitn height 

18 { 

19 wIm = tfeth. round ( (float) readerRect. height * { float )wlm / 

20 {float)hIrn ) ; 

21 him = readerf^t -height; 

22 ) 
23 

24 ' int fulllitBgeHeight = him + ((yb > ys) ?oneSetOff :0) ; 

25 if (yb + fullImageHei^t > readerRect.y + readerRect .height) 

26 { // not enou^ roan in 

27 this (partial?) colurm 

28 if (lastColurm) break draw; // no more columns 

29 left to fill 

30 nextColurmO ; 

31 rollBackO; 

32 ) 

33 else if (yb > ys) 

34 { 

35 yb += oneSetOff ; // i^per spacing 

36 ) 
37 

38 int xlm = ^ + (colWidth - wIm)/2; // center it 

39 

40 g.fillRect(xIm, yb, wIm, him); 

41 g.drawImage(theajrBge, xlm, yb, wIm, him, this); 

42 endlndex += para.lQigth( ) ; // i^xaate locaticn 

43 yb += him; // image sizing 

44 IcwesftectAreaBaseliine = Math.max(lowestTe>ctAreaBaseLine,yb) ; 
45 

46 yb += oneSetOff 

47 + tectHeight + readerLeading; // image spacing 

48 ^ if (yb > ye) // no roan for text 

49 under image margin 

50 { 

51 if (lastColumn) break draw; // no more columns 

52 left to fill 

53 nextColurm ( ) ; 

54 • } 

55 } 

56 } 

57 else // none of the 

58 above... 

59 { 

60 // dbg( "... new paragraph text : 

61 "+para. substring(0, Math. min(20, para. lengthO ) ) ) ; 
62 

63 priorBnptyPara = false; 

64 

65 if (formattedltext && fioishPullQuot^Itext) 

66 { 

67 textAlign = CHSriER; 

6Q this. setFont(Color. blue, readerPQuoteFont, g) ; 

69 } 

70 
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1 te = jd); // start a new line 

2 StringTbkenizer words = 

3 new StringTbkenizer (para, BL, true) ; // "true" returns 

4 v^te spaces 
5 

6 v^le {words.hasMDretokoisO) 

7 { 

8 nextWbrd = words.nextTbkenO ; 

9 nextWidth = te>ct^trics.stringWidth{nextWord) ; 
10 

11 if (te + ne>ctwidth < xe) // it will fit cn 

12 this line, so add it on 

13 '{ 

14 thisLine . append (nextWord) ; 

15 te += ne>ctWidth; 

16 ne>ctWDrd = MT; 

17 nextWidth = 0; 

18 } 

19 else // it wcn't fit if 

20 added, so draw the tejct 

21 { 

22 if (thisLine. length 0 > 0) // not if a iranster 

23 is first in the article 

24 { 

25 // dbg ("new line = t"+thisliine+"] , nextVtord = 

26 ["+nextWord+''] ") ; 

27 endlndex += this. draWIiext (thisLine, g) ; 

28 thisLine. setLength(O) ; // start the new line 

29 } 
30 

31 if (yb > ye) // start a new 

32 colurm? 

33 { 

34 if (lastColurm) break draw; // no rrore columns 

35 left to fill 

36 nextColijrm 0 ; 
37 

38 v^le (thisLine. toStringO .startsWith(BL)) 

39 { // ignore preceeding 

40 blan3cs on new line 

41 String noBlank = thisLine . toString ( ) . substring (1) ; 

42 thisLine . setLength ( 0 ) ; 

43 thisLine. append (noBlank) ; 

44 endlndex:++; 

45 } 

46 . - ) 
47 

48 if {thisLine. length 0 == 0) 

49 • irthile (ne>ctWord.startsWith(BL) ) // ignore preceeding 

50 blanks on new line 

51 { 

52 nextVtord = nextWord. substring (1) ; // look again 

53 nextWidth = textMetrics. stringWidth (nextWbrd) ; 

54 endlndex++ ; 

55 } 

56 thisLine . append (nextWord) ; 

57 te = xb + nextWidth; // possibly a 

58 nonster! 

59 nextWbrd = MT; 

60 ■ nextWidth = 0; 
61 

62 vttle (te > xe) // shorten the line 

63 by breaking the word 

64 { 

65 7/ dbg( "it's big: thisLine = [ "+thisLine+" ] " ) ; 

66 l^Mle (te > xe) // transfer letters 

67 back until fit (one line) 

68 ( 

69 ' int e = thisLine. length 0; 
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1 nextWord = thisIjjie.toString() .substring (e-l,e) + 

2 nextWbrd; 

3 String truncated = thisLine . toString ( ) . substring (0,e- 

4 1); 

5 thisLine. setliength(O) ; 

6 thisLine . a$3pend { truncated) ; 

7 // dbgC - try thisLine = ["+thisLine^-'']\n. . .and nextWbrd 

8 = [-+nextWbrd+")''); 

9 te = jdD + 

10 textMetrics . stringWidth ( thisLine . toString ()+"-•'); 

11 } 

12 thisLine.appendC-") ; 

13 endlndex += this. draWText (thisLine, g) - 1; 

14 thisLine. setLength(O) ; // start the new line 
15 

16 if (yb > ye) // start a new 

17 oolurtn? 

18 { 

19 if (lastCol\jrm) break draw; // no more columns 

20 left to fill 

21 nextColurm ( ) ; 

22 ) 

23 thisLine . append ( nextVford ) ; 

24 te = xb + textMetrics. stringWidth(thisLine.toString() ) ; 

25 nextWord = MT; 

26 nextWidth = 0; 

27 ) 

28 } 

29 } . // no more words in 

30 this paragra^ih 

31 if (thisLine. length {) > 0) 

32 endlndex += this. draWText (thisLine, g) ; 

33 thisLine. setLength(O); // start the new line 
34 

35 if (yb > ye) // start a new 

36 colurm? 

37 { 

38 if (lastColumn) break draw; // no rrore columns 

39 left to fill 

40 nextColurmO ; 

41 } 

42 nextWord = MT; // starting fresh 

43 . nextWidth = 0; 

44 te = 5dD; // pixel width of 

45 this line's words 

46 ) 

47 finishPullQuoteText = false; 

48 ) // end of draw label block // no more paragraphs 
49 

50 v^le (endlndex < endText 

51 && textContent.substring(endIndex++) . start sWith(BL) ) ; // skip blanks 
52 

53 g . setColor (getForeground ( ) ) ; 

54 // left arrow 

55 if (readerPageJ^Jum > 1) 

56 { 

57 int X = abackRect.x + 2 

58 , y = abackRect.y + abackRect .height/2; 

59 for (int anxw = 0; arrow < controlSize; arrow++) 

60 { 

61 g.drawLine 

62 ( X + arrow 

63 ^ y _ arrow/2 

64 , X + arrow 

65 / y + arrow/2 

66 ); 

67 } 

68 } 

69 // close box 

70 if (readerFrame) 
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1 { 

2 int X = closeiRect.x + 2 

3 , y = closeRect.y + 2 

4 , w = closeRect.widt±i - 5 

5 , h = closeRect.hei^t - 5; 
6 

7 g.dra>S^ect(x, y, w, h) ; 

8 g.draMCiine(x, y, x-hw, y+h) ; 

9 g.drawLine(x+w, y, x, y+h) ; 

10 ) 

11 // right armv 

12 if (endlndex < erxJItext) 

13 { 

14 int X = aheadRect.x + aheadRect .width - 2 

15 , y = abackRect.y + abackRect.heic^t/2; 

16 for (int arrov = 0; arrw < controlSize; arrow++) 

17 { 

18 g.drawliine 

19 { X - errxM 

20 / y + anxw/2 

21 , X - arrow 

22 , y - arraw/2 

23 ); 

24 } 

25 } 

26 return endlndex; 

27 } 
28 

29 private final synchronized void resetReaderView( ) 

30 { 

31 // dbg { " ezrpnlap . resetReaderView ( ) " ) ; 
32 

33 readerStartlndex = 0; ' 

34 readerEndlndex = 0; 

35 readerNumPages = 0; 

36 readerEst Pages - 1; 

37 readerF^geNum = 1; 

3 8 readerPageStart . removeAl lElement s ( ) ; 

39 readerF&geStart.addElement(new Integer (readerStartlndex) ) ; 

40 } 
41 

42 public final void dispose () 

43 { 

44 // dbg ( " ezrpnlap . dispose ( ) " ) ; 
45 

46 if (readerScreen != null) 

47 readerScreen . flush ( ) ; 

48 } 
49 

50 public synchronized void \4x3ate (Graphics g) 

51 { 

52 // dbg ( "ezrpnlap. update ( ) " ) ; 
53 

54 // f illRect is ISDT performed here to eliminate blank screen boredcm during 

55 offscreen drawing 
56 

57 // g . setColor ( getEackground ( ) ) ; 

58 // g.fillRect(0, 0, width, height); 

59 // g . setColor (getForeground ( ) ) ; 
60 

61 paint (g) ; 

62 } 
63 

64 private final synchronized void dbg (String s) 

65 ■ { 

66 if (debug) S/stem.out .print In (s) ; 

67 ) 

68 private boolean debug = false; // Print debugging info? 
69 

70 private final synchronized void repaintReaderScreen ( ) 
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1 { 

2 // dbg { "ezrpofilap. repaintReaderScreen ()••); 
3 

4 readerScreenI>irty = true; 

5 r^^aintO; 

6 } 
7 

8 private final synchronized int calculateReaderCOlurms ( ) 

9 { 

10 // dbg { "ezrpnlap . calculat^eaderColurms ()**); 

11 

12 int nurtCols = 1; 

13 

14 Rectangle r = bounds ( ) ; // rectangle of ezrpnlap 

15 int nurrChar = 30; // the control parameter: min # of n's per line of 

16 text 

17 int targetWidth = nurrChar * getFontMetrics (readerScreenFont) .stringWidthCn") ; 
18 

19 setReaderRect (r) ; 

20 nurrCols = (r .width) /targetWidth; 
21 

22 if (nurrCols < 1) 

23 nurrCols = 1; 
24 

25 return nijrrCols; 

26 ) 
27 

28 private final synchronized int draWText (StringBuf fer thisLine, Graphics g) 

29 { 

30 // dbg("ezrpnlap.draWIfext (\""+thisLine.toString()+"\") ") ; 
31 

32 g. drawstring 

33 ( thisLine.toStringO 

34 , xb + textAlign*(colWidth + xb - te)/2 

35 , yb 

36 ); // draw the text 

37 IcMestTextAreaBaseLine = Math.nBx(lowestTisxtAreaBaseLine,yb) ; 

38 yb += textHeight + readerLeading; // drcp down to another line 

39 checkShortLine ( ) ; 
40 

41 return thisLine . length ( ) ; 

42 } 
43 

44 • private final synchronized void checkShortLine ( ) 

45 { 

46 // dbgC'ezrpnlap.checkShortLineO ") ; 
47 

48 if (lastColurm 

49 && (lastRow = (ye - yb) <= (textHeight + readerLeading) ^2) )• 

50 { 

51 if ( reader PageiNum > 1) // left arrow 

52 xe = abackRect.x; 

53 else if (readerFrame) // close box 

54 xe = closeRect.x; 

55 else // right arrow 

56 xe = aheadRect.x; 

57 } 
58 

59 // dbgC'ezrpnlap.checkShortLineO: new xe = "+xe) ; 

60 ) 
61 

62 private final synchronized void nextColurm ( ) 

63 { 

64 // dbg ( " ezrpnlap . nextColumn ( ) " ) ; 
65 

66 colNumf+; // finished another colum 

67 lastColurm = colNum == nurrColumns - 1; 

68 // . clearlnitialSpaces = true; 
69 
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1 


yb = ys; 


// local baseline of first 


2 


line 




3 


>dD += colSpacincf; 




4 


oolurm area 




5 


te += colSpacing; 


// local end of text 


6 


xe += colSpacing; 


// local ri^t edge of the 


7 


colum area 




8 
9 


checkShortliine ( ) ; 




10 


} 




11 






12 


private final synchrcnized void setFontCFont f, Graphics g) 


13 


{ 




14 


// dbg( "ezrpnlap.setFont ("+£+")") ; 




15 






16 


textMetrics = getFontMetrics{f ) ; 




17 


textHeic^t = f .getSizeO *5/4; 




18 


g.setFcalt (f ) ; 




19 






20 


// dbg ( " ezrpnlap . setFont ( setFont ) : textHei^t = 


"+textHeight) ; 


21 


} 




22 






23 


private final synchronized void setFont (Color c. 


Font f, Graphics g) 


24 


{ 




25 


// dbgC'ezrpnlap. ("+0+", "+f+", g)"); 




26 






27 


g.setColor(c) ; 




28 


setFont (f, g); 




29 


) 




30 






31 


private final synchronized void rollBackO 




32 


{ 




33 


// dbg ( " ezrpnlap . rollBack ( ) " ) ; 




34 






35 


if (yb == ys && drawPullUhderliner && IfinishPullQuoteText) 


36 


( 




37 


• yb = readerRect.y 




38 


+ readerRect. height 




39 


- pull^oteLineWidth; 


// roll back to base of 


40 


previous colurm 




41 


oolNum — ; 




42 


lastColumn = false; 




43 






44 


5dD -= colSpacing; 


// local left edge of the 


45 


column area 


46 


te -= colSpacing; 


// local end of text 


47 


xe -= colSpacing; 


// local right edge of the 


48 


column area 




49 






50 


else if (yb > ys) 




51 






52 


yb -= (textHeight + readerLeading) /2 ; 


// roll back half of last CR 


53 






54 


else 




55 






56 


yb = readerRect .y; 


// start at the tcp 


57 




58 


} 




59 


} 




60 






61 


/** 




62 


* sanple web page with applet tag 




63 


*/ 




64 


<HTML> 




65 


<HEAD> 




66 


<MEm NAME= "GENERATOR" CXMENr="Mobe Pagdy[ill 2.0 Mac"> 


67 


<TITLiE></TTTLE> 




68 


</HEfiD> 




69 


<Bcro> 




70 
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1 opplet oocM5ase=''ez_class'' code="e2_text. class" widt±i=300 heic^t=200> 

2 <param nanes" filename" value=''ezsarrple.txt''> 

3 </applet:> 
4 

5 </BCCV> 

6 </HIML> 
7 

8 /** 

9 * e2sarrple.txt web page for applet 

10 V 

11 "EZ Text Sanple Article 

12 ' "Click on the ^let" 

13 The reader screen presentation of content is interactive and optimized for 

14 readability. Font size can be changed ty pressing vp or down arrow k^^, or fcy 

15 clicking the Font+ or Font- buttons. Pages can be turned ty pressing hone, left, or 

16 ri^t k^s, or ty clicking the Hone, Previous, or Next buttons. 

17 " "cptimized for readability" 

18 Cne of the key advantages of this reader screoi presentation is its careful avoidance 

19 of a particular form of e/e-s train kncwn as optoJcinetic n/stagmus. N/stagnus, a 

20 reflexive jurtp in the muscles directing the eye, is triggered ty, for exarrple, 

21 vertical scrolling of text on a corputer screen. 

22 @ez_€ye.gif 

23 As nystagmus strain increases, muscle junps can beccine exaggerated and even erratic, 

24 finally resulting in a perception of visual weariness. I^stagmus is well-known as a 

25 side-effect of excessive alcohol: a sirrple road-side test conducted ty law officers 

26 can aid in determination of a possible EWI offense. Other possible causes of n/stagmus 

27 include general physical exhaustion and illness. 
28 

29 While the term "rystagmus" way have been unfamiliar, the condition is aicountered in 

30 iTHny circumstances, none of vsiiich is very pleasant. 

31 ' "optokinetic n/stagrnos" 

32 The main side effect of optokinetic rystagmus induced ty scrolling text is a tendency 

33 to print the document, so that it can be read later with greater confort. This 

34 internets delivery of content and consumes resources. It is very possible that the 

35 demise of the paperless office dreams of the '80's was caused in part ty nystagmus. 

36 Another rrajor cause of its denise was the difference in formatting between standard 

37 paper, hei^t being typically 30% greater than width, and standard ccnputer monitors, 

38 width being typically 33% greater than height . Word processors targeted paper 

39 formatting, so that documents delivered fron ccrrputer to corputer were not easily 

40 adapted to screen fomBts. This pattern also resulted in a tendency to print such 

41 documents rather than struggle to consume their contents on screen. 
42 

43 EZ Text solves these twin problats nicely. First, there is no scrolling text, 

44 resulting in reduced eye-strain. Font sizing can be adjusted ty the reader for his 

45 particular situation of lighting, monitor quality and size, and his personal visual 

46 comfort. Second, The content is automatically laid out in columns of text, with 

47 neither too few words in a line, about 30 characters minimum, nor too many, about 60 

48 characters maximum. The upper limit yields a line length ^^toch, as the human eye 

49 executes its rapid raster motion to the beginning of the next line, is not too long to 

50 accurately and easily find the correct next new line. If lines are much shorter, below 

51 the minimum, lines of text contain too little content, and the frequent raster motions 

52 can induce ^e-strain. 

53 ' "Web pages . . . becone a rewarding e>^)erience with EZ Tfext. " 

54 This sairple document contains about 3300 characters in about 640 worxfs. At normal 

55 reading speeds, it should take about 5 minutes to absorb its itain content. The effort 

56 required to read this article on the screen, using EZ Tfext, should be noticeably less 

57 than required ty other channels. For instance, using a word processor, two approaches 

58 . are ccimon. The first is to print it out, collect the page(s), and finally read it. 

59 Alternatively, one could open the document in a word processor, adjust window widths 

60 and zoon factors, and finally read it, occasionally scrolling to bring unseen parts 

61 into view. With EZ Text, just sit back, tap the up arrow to adjust the font, and tap 

62 the right arrow to turn the page as needed. Web pages, known widely as challenging 

63 v\*aen it cores to delivering on-screen content, can becore a rewarding experience with 

64 EZ Tfext. 
65 
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